home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk50 / geotime / readme.first < prev    next >
Text File  |  1995-03-18  |  10KB  |  232 lines
  1.                   Geotime - The "Ultimate" (?) Amiga clock
  2.  
  3.                        Copyright 1988 by Mike Smithwick
  4.  
  5. Like many people, I was getting pretty board with the plethora of rather
  6. dull little workbench clocks (mouse pointer clocks, Boing clocks, etc), I
  7. decided to write Geotime. 
  8.  
  9. Geotime actually consists of two separate programs, Geotime_m depicts a 
  10. earth map with day and nite sides shaded. You'll be able to observe the
  11. earth's shadow scroll across the map in real-time based on the system clock.
  12.  
  13. The other program, Geotime_g is a workbench clock, and shows the earth as a 
  14. globe with day and nite sides. Like the map, the shadows will progress in
  15. real-time showing the current phase of the earth.
  16.  
  17. And now a word from our sponsor:
  18.  
  19. Geotime is freely distributable, as long as this notice stays intact.
  20. However, this is, "Shareware" (oh no Mr. Bill, not shareware!). Wait! Don't
  21. go!! I know that the shareware concept is much overused, particularly since
  22. most shareware products aren't worth it. If you do enjoy this program, I would
  23. enjoy, say, $17. This will ensure a free upgrade which will not be
  24. freely distributable. Please feel free to  suggest further features for the 
  25. next version. I expect to have higher detailed maps, zoom in/out, time-
  26. zone boarders, etc.
  27.  
  28. Mail you generous cash contributions to :
  29.  
  30.                 Mike Smithwick
  31.                 25215 La Loma Drive
  32.                 Los Altos Hills, CA   94022
  33.  
  34. This of course assumes that there is enough interest to warrent further time
  35. spent on this.
  36.  
  37. "And we thank you for your support".
  38.  
  39.  
  40. ----------------------------------------------------------------------
  41.  
  42.                                  Geotime_m
  43.  
  44. Geotime_m will display a map of the earth showing the current day and
  45. nite regions. The shadow will scroll across the map in real time.
  46. This program was inspired by "Geochron", the beautiful, illuminated large wall
  47. map that costs around $4 million bucks (actually, about 2 grand).
  48.  
  49. It is started in the traditional double-click icon method. For those who
  50. despise workbench, it may be started up from CLI by typing 
  51. "geotime_m -f coast2.sm.bin".
  52.  
  53. City and country names are read from the file "gtnames.dat". Each
  54. entry requires 3 lines in the following format :
  55.  
  56.                       name
  57.                       lat long
  58.                       time_zone
  59.  
  60. West longtitude is negative, East is positive. The time-zone is the value
  61. the must be added to your time to equal Universal Time. Most almanacs should
  62. have timezone entries for major cities.
  63.  
  64. Here's a sample entry :
  65.  
  66.                        .San Francisco
  67.                        38 -122
  68.                        7
  69.                        .Seoul
  70.                        37 127
  71.                        -9
  72.                        .London
  73.                        51 0
  74.                        -100
  75.  
  76. Time zones are floating point values since some zones are fractional hours.
  77. (The timezones in the sample file may not be correct due to the uncertainties
  78. of Daylight times around the world).
  79.  
  80. Each name will automatically be followed by a clock showing the time in
  81. 24 hour mode. Using a time-zone value of "-100" (as in the London entry)
  82. will prevent the clock from being displayed to avoid excess screen clutter.
  83.  
  84. The period before the name is used to more clearly pinpoint the location.
  85.  
  86. The star-like sprite shows the "sub-solar" point, the point on the Earth
  87. directly under the sun.
  88.  
  89. There are a couple of options you may change by use of the Workbench
  90. Icon "Tooltypes" facilities. These are used to pass startup information on to a
  91. program. Click once on the icon, then select "info" from the workbench
  92. menu. You will now see the "Info" window displaying all sorts of curious
  93. attributes about it's associated file. Near the bottom is the "TOOL TYPES"
  94. string gadget. Click on the arrows, and you see 3 different startup options.
  95. "GLOBEDATA" tells the program where to get it's map data file. For Geotime_m
  96. there is currently only one file, "coast2.sm.bin", so you don't need to touch
  97. this unless you move the datafile over into another directory. Next is the
  98. "TIMEZONE" argument. This is the timezone for your location, and is determined
  99. the same way as all other timezones. The program uses this to convert the local
  100. time on your system's internal clock to Universal time. It is currently set up
  101. for Pacific time. You may also change the landmass colors using "LANDCOLOR".
  102. The following 3 numbers are the red, green and blue components. So if you wanted
  103. magenta land you would type "LANDCOLOR=15,0,15", or all red, no green, all blue.
  104. (The color values go frome 0 to 15). When done modifying the tooltypes, click
  105. on save. You may want to open the info window one more time to verify that your
  106. numbers were correctly recorded, as I ran in to some problems in this regard.
  107.  
  108. Geotime_m requires the use of a special font, "flow_thin". In order to
  109. install the font, open a cli window and type "execute gt:font_install".
  110.  
  111. There are a couple of menu options that allow you to toggle on/off the
  112. clocks, names, and a clock in the menubar.
  113.  
  114. ---------------------------------------------------------------
  115.  
  116.                                  geotime_g
  117.  
  118.  
  119. Geotime_g will depict the earth as if you will an astronaut orbiting about
  120. 300 zillion miles up. The earth's shadow will be correct for the date and
  121. time, and will advance as time itself advances.
  122.  
  123. Start this up via the icon, or CLI as mentioned above using 
  124. "geotime_g -f coast2.bin". (Notice that different data files are used for
  125. each program).
  126.  
  127. At startup you are in "orbit" mode, in which the viewpoint in effect 
  128. "orbits" around the planet. (otherwise it would be a really boring display.)
  129.  
  130. Geotime will work in both interlace and non-interlaced modes. Although
  131. it looks the niftiest in Hi-res interlace with dropshadow.
  132.  
  133. Since Geotime uses your own workbench colors you may have reset your
  134. preference colors for what looks best on both Geotime and your workbench.
  135. Colors are very important. The water should be dark-blue, land masses
  136. brown/orange or green, sky-black. In order to see the colors I used, 
  137. I've included my own "system-configuration" file on the disk which 
  138. hold my preference data. You may want to substitute this for your own 
  139. in the df0:devs directory.
  140.  
  141. There is just one Tooltype entry for this one, and that is "GLOBEDATA". 
  142. As with the Geotime_m, there is currently only 1 file, "coast2.bin".
  143.  
  144. If the globe is not circular, your monitor may need some adjustment.
  145. It may take an update or two for any changes in the settings window
  146. to take affect.
  147.  
  148. Geotime_g has several menu options. . .
  149.  
  150.                              System menu
  151.  
  152. In the systems menu, "settings" will allow you to set some basic
  153. information needed. Timezone is the number of hours which you need to 
  154. add to your local time to arrive at Universal Coordinated Time (the old 
  155. "GMT"). +7 is good for the SF Bay Area.
  156.  
  157. View lat : sets the viewer latitude. Defaults to 0 degrees. (dd.mm format)
  158.      Setting this positive will put you above the equator when looking
  159.      at the globe.
  160.  
  161. View long : sets the viewer longtitude. Defaults to 0 degrees. This advances
  162.      5 degrees each update while in orbit mode.
  163.  
  164. Lat : user's latitude. Put your home's latitude here for the "location"
  165.      highlight option. 
  166.  
  167. Long : user's latitude. Put your home's longtitude here.
  168.  
  169. Save : This will save all of your settings to a file, "geotime.dat".
  170.  
  171. If you make a mistake, the screen will flash a bunch of times and you won't
  172. be able to leave the requestor.
  173.  
  174. The latitudes go from -90 to +90 degrees. Longtitudes go from 180 W to 0 to
  175. 180 E. So for instance, the longtitude for San Francisco, 122:27 degrees 
  176. West, would be entered as "122.27 W".
  177.  
  178.                           Neat Stuff menu
  179.  
  180. Highlights : "Continents" will put an outline on the land masses. 
  181.      "Location" will put a "*" at whatever location you specify in 
  182.      the settings window.
  183.  
  184. Indicators : "Clock" will display the current date and time, while
  185.      "legend" shows how the sunny side is colored vs. the shaded side.
  186.  
  187. Mode : This lets you toggle between the orbit/hover rotational modes. 
  188.      "Orbit", the default, presents the planet to you as if you were
  189.      orbiting around in a very fast spacecraft from West to East. "Hover" 
  190.      puts you above a fixed point specified by the view lat/view long 
  191.      entries in the settings window. Hover is a really dull mode.
  192.  
  193. Shadow : "Shaded", the default, gives you a shadow tint, while "black" will
  194.      completely blacken the shadow to more closely mimic the view from 
  195.      space.
  196.  
  197. ---------------------------------------------------------------------
  198.  
  199.                                      Misc
  200.  
  201. The data used contains about 3000 points culled from a 6000 point
  202. database. (I may release the larger one sometime, it doesn't look that much
  203. better on the globe, but it is quite nice on the map).
  204.  
  205.  
  206. ---------------------------------------------------------------------
  207. (Warning! Warning! The following is an unabashed commercial announcement!)
  208.  
  209. If you do enjoy this program, you may want to take a look at something else
  210. I've done. It's called "Galileo", and is an astronomy simulation. It will
  211. display up to 9100 stars in a fashion more realistic than any other
  212. micro-computer planetarium simulation.
  213.  
  214. Galileo has won an award in the May Consumer Electronics Show for the most
  215. innovative Educational Program of the Year.
  216.  
  217. A recent review in Sky and Telescope magazine called Galileo "powerful and
  218. visually stunning", and many users write in to me saying things like
  219. "at last, a program that justifies my Amiga", or "Wonderful!".
  220.  
  221. Galileo is not meant just for folks with a telescope, but for anyone who
  222. has ever wondered about what's up in the night sky. (As a matter of fact,
  223. only a handful of owners stated they had a telescope. But those who do
  224. love the program).
  225.  
  226. So, when you're tired of exploring fictional universes, give the real
  227. one a shot, I think you'll enjoy it.
  228.  
  229.              (End of the unabashed commercial announcement!)
  230.  
  231.  
  232.